home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 041a / vfits012.zip / VIEWFITS.DOC < prev    next >
Text File  |  1993-04-29  |  3KB  |  92 lines
  1. ViewFITS : FITS viewer for OS/2 PM.
  2. -----------------------------------
  3.  
  4. Current status: Version 0.1, release 2, April 29, 1993
  5.  
  6. Introduction:
  7. ------------
  8.  
  9. ViewFITS is a FITS viewer for the OS/2 PM.  "FITS" stands for "Flexible
  10. Image Transport System", a standard in use for many years by professonials.
  11. ViewFITS, in the current version, can display images of any format, 8 to 32
  12. bits per pixel.  The color palette (LookUp Table) can be easily modified to
  13. help the user to get the maximum of the image. Let's see the principal
  14. characteristics.
  15.  
  16.  
  17. Handling datas:
  18. --------------
  19.  
  20. In the present version, new image can only be gotten via menu (FILE/NEW).
  21. In a future release, we project to make the application be able to
  22. read arguments on command line and use pipes to communicate with other
  23. programs.  It will then be used as a "client" program.
  24.  
  25.  
  26. The color palette:
  27. -----------------
  28.  
  29. The color palette, or lookup table, contains 64 colors.  They are scaled
  30. via a linear equation.  So, the user can modify the slope and the intercept
  31. of the palette to customize the display has s/he wants.  In all cases,
  32. datas are processed to be spread over all the dynamic range of the palette:
  33.  
  34. e.g.:
  35.  
  36. Your image has pixels with values from 100 to 300, so the dynamic range is
  37. 200.  The intercept of the image is then Ii=100 and the slope is given by
  38. Si= (number of color) / (dynamic range) = 64/200 = 0.32.
  39.  
  40. This way, each a pixel is drawn, its color is Cp=(Vp - Ii) * Si.  Let's
  41. imagine we have Vp=150, Cp = (150 -100) * 0.32 = 16.  Pixels with Vp=100
  42. will get Cp=0 and Vp=300, Cp=63 (not 64!) where Cp is the color index, i.e.
  43. the position in the lookup table.
  44.  
  45. The menu PALETTE allows the user to modify the slope and the intercept of
  46. the lookup table.  This way, a given pixel will always have the same color
  47. index but the corresponding color value will change.
  48.  
  49. It is not easy to see first, but the slope cursor goes from slope=0 to
  50. slope=INFINITY as the tangent with 1 at center.  The intercept cursor goes
  51. linearly from 0 to 63.
  52.  
  53. The current version doesn't allow the user to do negativation (reversing
  54. the lookup table).  But it is planned for a close future.
  55.  
  56.  
  57. Known bugs:
  58. ----------
  59.  
  60. Here is a short list of know bugs:
  61.  
  62. 1- There is an error in the palette manager (I have nothing to do with this).
  63. If you have a window that modify the palette over the image, the palette
  64. won't be restored once the window has moved.  To correct that, use REFRESH.
  65.  
  66. 2- Because it use palette manager, this application cannot be used under OS/2
  67. 2.0.  It only works under version 2.1 beta.
  68.  
  69. 3- If you use the palette controler, be aware to put the slope cursor near the
  70. center if you don't care about slope, otherwise the slope will be set to 0 and
  71. all the image will be black.
  72.  
  73. 4- Drawing is very slow!  Bitmapping will be implemented soon.
  74.  
  75.  
  76. Unknown bugs:
  77. ------------
  78.  
  79. I'm waiting for your reports!  You can join me via e-mail at
  80.  
  81. beaucham@phy.ulaval.ca
  82.  
  83. or on the FIDONet forum "astronomy echo".
  84.  
  85.  
  86. VERSION 0.1, is FREEWARE.
  87.  
  88. Dominique Beauchamp
  89. Quebec City
  90. April 29, 1993
  91.  
  92.